home *** CD-ROM | disk | FTP | other *** search
/ Fritz: All Fritz / All Fritz.zip / All Fritz / FILES / BUSINESS / STATA3.LZH / DEMO.TUT < prev    next >
Text File  |  1988-08-30  |  9KB  |  281 lines
  1. set output error
  2. set more 1
  3. mac def path
  4. capture run frstpage.tut
  5. if _rc {
  6.     mac def path "\stata\"
  7.     capture run %path`frstpage.tut
  8.     if _rc {
  9.         mac def path "/usr/stata/"
  10.         capture run %path`frstpage.tut
  11.         if _rc {
  12.             #delimit ;
  13.             di in red
  14. "I cannot find the other tutorial files.  I have looked in the current" _n
  15. "directory and in \stata (DOS) or /usr/stata (Unix).  Is Stata installed" _n
  16. "correctly?" _n(2)
  17. "In any case, I cannot run the tutorial." ;
  18.             #delimit cr
  19.             exit
  20.         }
  21.     }
  22. }
  23.  
  24. #delimit ;
  25. capture program drop _demo ;
  26. program define _demo ;
  27. macro define F5 "do %path`contents.tut;" ;
  28. macro define F6 "do %path`demo.tut;" ;
  29.  
  30. di _n(4) in wh
  31. "  ___  ____  ____  ____  ____ tm" in gr _col(68) "page 1 of 9" in wh _n
  32. " /__    /   ____/   /   ____/" _n
  33. "___/   /   /___/   /   /___/    An Introduction" _n
  34. "-----------------------------------------------" _n ;
  35.  
  36. di in gr
  37. "Welcome to Stata.  This is one of several tutorials designed to introduce you"
  38. _n
  39. "to the Stata system." ;
  40.  
  41. di in gr _n
  42. "Stata is a program for manipulating, displaying, and analyzing data.  It is" _n
  43. "not only easy to use, but it is extremely powerful as well.  Rather than pre-"
  44.  _n
  45. "senting all of Stata's capabilities in a single tutorial, we have grouped the"
  46. _n
  47. "more important features into separate tutorials.  The overlap is minimal, so"
  48. _n
  49. "we encourage you to view them all." ;
  50.  
  51.  
  52. di in wh _n(2)
  53. "How to page through a tutorial" _n
  54. _dup(32) "-" _n ;
  55.  
  56. di in gr
  57. "Stata tutorials display a screen of information at a time, then they pause to"
  58. _n
  59. "give you time to read the screen.  The message "
  60. in wh "--more--" in gr " is displayed at the" _n
  61. "bottom of the screen whenever the tutorial is ready to proceed.  When you are"
  62. _n
  63. "ready to continue, press the space bar." _n ;
  64.  
  65. more ;
  66.  
  67. di in wh _n(4)
  68. "How to STOP a tutorial" in gr _col(68) "page 2 of 9" in wh _n
  69. "----------------------" _n ;
  70.  
  71. di in gr
  72. "All of the tutorials will stop themselves when they have told you everything"
  73. _n
  74. "they have to say.  You can, however, force a tutorial to stop by pressing the"
  75. _n
  76. in wh "Break" in gr " key.  On a PC, you do this by holding down "
  77. in wh "Ctrl"
  78. in gr " and pressing "
  79. in wh "Break" in gr ";" _n
  80. in gr "under Unix, you hold down "
  81. in wh "Ctrl" in gr " and press " in wh "C" in gr
  82. ".  If you do that, you will see" _n
  83. "something like this:" _n ;
  84.  
  85. di _col(15) in blue "end of do-file" _n
  86.    _col(15) in red  "--Break--" _n
  87.    _col(15) in blue "r(1);" _n(2)
  88.    _col(15) in wh ". _" _n ;
  89.  
  90. di in gr
  91. "Stata will then wait for you to type a command.  Since you have no idea what"
  92. _n
  93. "the Stata commands are, it would not be a good idea to press "
  94. in wh "Break" in gr " right now." _n
  95. "But hold onto the idea; on the next screen we'll show you the only two com-" _n
  96. "mands you need to know so that you can go exploring on your own.  This tuto-"
  97. _n
  98. "rial will end shortly." _n(3) ;
  99.  
  100. more ;
  101.  
  102. di _n(3) in wh
  103. "The only two commands you need to know" _col(68) in gr "page 3 of 9" in wh _n
  104. _dup(38) "-" _n(2) ;
  105.  
  106. di in wh "do %path" in gr "_______" in wh ".tut" _n(2) in gr
  107. "     When this tutorial is over, type the above command to run another of" _n
  108. "     the tutorials.  Fill in the blank with the name of a tutorial."
  109. _n(2)
  110. "     There are many tutorials on this disk.  You can obtain an index of them"
  111. _n
  112. "     by typing" _n(2)
  113. _col(16) in wh "do %path`contents.tut" in gr _n(2)
  114. "     or by pressing the "
  115. in wh "F6" in gr " key.  We are going to do that in a second." _n(2) ;
  116.  
  117. di in wh "exit, clear" _n(2) in gr
  118. "     If you want to return to your operating system, type '"
  119.       in wh "exit, clear" in gr "'."  _n(3) ;
  120. more ;
  121.  
  122. di _n(2) in wh
  123. "Two other commands you might want to know" _col(68) in gr "page 4 of 9" in wh
  124. _n _dup(41) "-" _n(2) ;
  125.  
  126. di in gr "'" in wh "help" in gr "' or pressing "
  127. in wh "F1" in gr " and then pressing " in wh "Return" _n in gr
  128. "     Stata's always ready to assist you.  When this tutorial is over," _n
  129. "     you can type '" in wh "help" in gr "' whenever you're confused."
  130. _n(3)
  131. "Pressing " in wh "F10" in gr " (DOS only)" _n
  132. "     Stata has a fullscreen menu system.  It's easy to use and you can" _n
  133. "     try it when this tutorial is over.  But before you try it for the" _n
  134. "     first time, please type '" in wh "help menu" in gr "'." _n(2)
  135. "     There's a catch:  The menu system will only work on IBM computers or" _n
  136. "     computers that are 100% IBM compatible.  Stata under Unix does not" _n
  137. "     have a menu system." _n(6) ;
  138.  
  139. more ;
  140.  
  141. di _n(2) in wh
  142. "The other tutorials" _col(68) in gr "page 5 of 9" in wh _n
  143. _dup(19) "-" _n(2) ;
  144.  
  145. di in gr
  146. "We told you that if you type" _n(2)
  147. in wh _col(16) "do %path`contents.tut" _n(2) in gr
  148. "you will obtain a list of the other tutorials." _n(2)
  149. "On the next screen, we'll show you what happens when you type this.  You" _n
  150. "needn't take notes since you can type '"
  151. in wh "do %path`contents.tut" in gr "'" _n
  152. "whenever you wish." _n(10)
  153. in wh ". do %path`contents.tut" ;
  154.  
  155. more ;
  156. run %path`contents.tut ;
  157. set di page 0 ;
  158.  
  159.  
  160. di _n(14) in wh
  161. "Some advice" _col(68) in gr "page 6 of 9" in wh _n
  162. "-----------" _n ;
  163.  
  164. di in gr
  165. "View the '"
  166. in wh "intro.tut"
  167. in gr "' tutorial first by typing '"
  168. in wh "do %path`intro.tut" in gr "'." _n
  169. "We've made it easy for you to run this tutorial; just press "
  170. in wh "F6." in gr _n(2)
  171. "The other tutorials focus on particular applications.  View any that inter-"
  172. _n
  173. "est you.  If you have a graphics-capable monitor, make sure you view the" _n
  174. "'" in wh "graphics.tut" in gr"' tutorial." _n ;
  175.  
  176. di in gr
  177. "Finally, don't worry if you don't understand some of the information dis-" _n
  178. "played during the tutorials.  You can't learn everything at once.  In fact," _n
  179. "you may find it helpful to rerun some of the tutorials after you've become" _n
  180. "familiar with Stata." _n ;
  181.  
  182. di in gr
  183. "If you have the demonstration version of Stata, you're seeing these messages"
  184. _n
  185. "because you typed '"
  186. in wh "DEMO" in gr "' to enter Stata.  You can skip them next time by" _n
  187. "simply typing '"
  188. in wh "stata" in gr "' in reponse to the operating system prompt." _n(5) ;
  189.  
  190.  
  191. more ;
  192.  
  193. di _n(2) in wh
  194. "Where to learn more" _col(68) in gr "page 7 of 9" in wh _n
  195. "-------------------" _n(2) ;
  196.  
  197. di in gr
  198. "The tutorials cover only a small fraction of Stata's capabilities, so you need"
  199. _n
  200. "to know where to learn the rest.  The best source of information is the "
  201. in wh "Stata" _n
  202. "Reference Manual" in gr
  203. ".  It's 800 pages long, indexed, and full of explanations and" _n
  204. "examples.  The next best source is the on-line help system.  It contains over"
  205. _n
  206. "500 screens of information.  It does not cover everything, and sometimes the"
  207. _n
  208. "explanations are terse, but it does cover the more important points."
  209. _n(2)
  210. "Because Stata is so easy to use, and because the on-line system appears so" _n
  211. "complete, users are sometimes fooled into thinking that Stata cannot do some-"
  212. _n
  213. "thing when it can.  This is because most statistical systems have separate" _n
  214. "programs, commands, or options for everything they can do.  Stata, on the" _n
  215. "other hand, is a language.  It is by combining elements of the language that"
  216. _n
  217. "you unleash the power of Stata." _n(5);
  218. more ;
  219.  
  220. di _n(2) in wh
  221. "A final note" _col(68) in gr "page 8 of 9" in wh _n
  222. "------------" _n ;
  223.  
  224. di in gr
  225. "We encourage you to experiment with Stata.  The same tutorial files are in-" _n
  226. "cluded with both the full professional version of Stata and the demonstra-" _n
  227. "tion version." _n(2)
  228. "In the demonstration version, we have removed the commands that make changes"
  229. _n
  230. "to the disk and we have limited the number of variables and observations" _n
  231. "that can be processed.  In all other ways, it is identical to the full"  _n
  232. "system." _n ;
  233.  
  234. di in gr
  235. "Either way, we have included some sample data sets.  To find out about them,"
  236. _n
  237. "view the '"
  238. in wh "ourdata.tut" in gr "' tutorial." _n(2)
  239. "You can also try Stata with your own data sets even if you only have the" _n
  240. "demonstration version.  View the '"
  241. in wh "yourdata.tut" in gr "' tutorial for instructions" _n
  242. "on how to do this." _n(5) ;
  243.  
  244. more;
  245.  
  246. macro define F6 "do %path`intro.tut;" ;
  247.  
  248. di _n(2) in wh
  249. "Finished" _col(68) in gr "page 9 of 9" in wh _n
  250. "--------" _n ;
  251.  
  252. di in gr
  253. "At the bottom of this screen, you now see:" _n(2)
  254. _col(15) in blue "end of do-file" _n(2)
  255. _col(15) in wh ". _" _n ;
  256.  
  257. di in gr
  258. "It's your turn to type a Stata command.  We recommend you now type" _n
  259. "'" in wh "do %path`intro.tut" in gr "' or, equivalently, press "
  260. in wh "F6" in gr "." _n(2)
  261. "Remember:  You can obtain a list of all the tutorials by typing" _n
  262. "'" in wh "do %path`contents.tut" in gr "' or pressing "
  263. in wh "F5" in gr "." _n(2)
  264. "Also remember:  There's nothing you can do to hurt the software, so" _n
  265. "experiment freely.  We hope you enjoy using Stata." _n(3);
  266.  
  267. end ;
  268.  
  269.  
  270. di in blue "When you are ready to continue, press the space bar ..." ;
  271. set more 0 ;
  272. more ;
  273. set display page 0 ;
  274. /* capture */ _demo ;
  275. #delimit cr
  276. if _rc==1 {
  277.     di in red "--Break--"
  278. }
  279. set display page 23
  280. program drop _demo
  281.